Release 10.1A: OpenEdge Development:
Progress 4GL Reference

ADD-CALC-COLUMN( ) method

Creates a browse column from the specified properties and returns the widget-handle of the new column. This method can be used only after the browse’s query attribute has been set.

Return type: WIDGET-HANDLE

Applies to: BROWSE widget

Syntax

ADD-CALC-COLUMN( datatype-exp , format-exp , initial-value-exp , label-exp [ , pos ] )

datatype-exp

Character expression specifying the data type ("CHAR", “DATE”, “DECIMAL”, “INTEGER” or “LOGICAL”)

format-exp

Character expression specifying the column’s format.

initial-value-exp

Character expression specifying the initial value. This may be a null string.

label-exp

Character expression specifying the column’s label.

pos

The optional integer value position of the browse column. If pos = 2, the column is the second column. If the position is not specified or the position is invalid, the new column is added at the end of the columns.

The following is an example of adding a column in the browse’s fifth position using this method:

CalcHnd5 = BrwsHndl:ADD-CALC-COLUMN("char", "AAA-99999", "ORD-37854", "OrdNum", 5).

Notes

The ADD-CALC-COLUMN( ) method may be used on a static browse as well as on a dynamic browse.
If the browse is already displayed, the REFRESH( ) method should be applied to the browse after columns are added using ADD-CALC-COLUMN( ). This will initially populate the viewport for the calculated column. The ROW-DISPLAY trigger would normally populate the column, but when ADD-CALC-COLUMN is being executed, the 4GL calc-column handle is not yet set and, thus, cannot initially populate it.